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Category 


Watch 
Battery 





INETaare 


Progress 


Setting 


Fill Ratio 


Operator 


(clamp(#BLN#, 0, 100)/100) 





Progress 0-50 








Fill Ratio 





(clamp(#BLN#, 0, 50)/50) 
















































































































Transparency | S#BLN#>0?100:0S 
Rotation ((clamp((100-#BLN#),50,100)/100)*360) 
Rotation ((clamp((100-#BLN#),0,50)/100)*360) 
Transparency | S#BLN#<=20?less:moreS 
Health Step Count Fill Ratio (clamp(#ZSC#, 0, 3000)/3000) 
Progress 
BPM Progress Fill Ratio (clamp(#ZHR#, 0, 200)/200) 
Miles Text ((round((#ZSC#*0.0476)))/100) 
OR 
((round((#ZS C#*2.65)/52.8))/100) 
Kilometers Text ((round((#ZSC#*0.00762)))/10) 
or 
((round((#ZS C#*2.4)/27.7))/100) 
KCAL Text (round((#ZSC#/20))) 
(AUTO) Miles/ | Text (100*(#UNITSYS#==METRIC)) -and- 
Kilometers (100*(#UNITSYS#==IMPERIAL)) btw, in miles it will be lower 
number ((round((#ZSC#*0.00762/1.6)))/10) 
Time Time Progress Fill Ratio (clamp(#DWFSSH#, 0, 360)/360) 
Second (clamp(#DWFSS#, 0, 362)/362) <- To only show 1 sec / this bar 
covers the second bar with a -1 deg rotation 
Ticks Per Sec (round(#DWFSS#*X/6)/X*6) 
Weather Temp Progress | Fill Ratio (clamp(#WCT#, 0, 72)/120) 
Forecast Text AWFBH#S/H#WFBL#HE 
Max/Min 1d 
Next Day Text S#DOW#=0?MON:SS#DOW#=1 PTUE:SSHDOW#=2 PWED:SSHDOW 
#=3?THU:SSHDOW#=4 PFRI:SSHDOW#=5 PSAT:SSHDOW#=6?SUN:S 
Date Day of Week Transparency | S#DOWB#=1?100:05 (1-7) 
Split Date Text Split the date in to 2 and display each number where ever you 














want 

to Get the first number I.E 0-3 
((#Dd#)-(#Dd#%10))/10) 

to get the second 0-9 
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(#Dd#%10) 
Orbiting Sun X-position: X-position: 
Hour Hand Y-position: (160+cos((#DWFHS#+90) *((pi)/180))*160) 
Min Hand 
Second Hand Y-position: 
[Time Based on (160+sin((#DWFHS#+90)*((pi)/180))*160) 
24 Hour 
Rotation — To offset the sun/moon lower during its time increase the + Y 
change point 
#DWFHS# for 
other] 
Moon X-position: X-position: 
(This is 180deg | Y-position: (160+cos((#DWFHS#-90)*((pi)/180))*160) 
from the other) 
[Time Based on Y-position: 
24 Hour (160+sin((#DWFHS#-90) *((pi)/180))*160) 
Rotation] 
To offset the sun/moon lower during its time increase the + Y 
point 
Rotation Rotation: HDWFSS# 
Fade/Color Time Hour Transparency | Time Hr Night -5 
Change S#Dk#<5 ?100:0S 
Time Hr Day +5/-20 
S#Dk#>=5& &#Dk#<=207100:0S 
Time Hr Night +20 
S#Dk#>20?100:0S 
Time Transparency | Time Hr Night -5 
Sunrise/Sunset S#Dk#<#WSUNRISEH24#?100:08 
Time Hr Day +5/-20 
S#Dk#>=#WSUNRISEH24#&&#Dk#<=#WSUNSETH24#?100:0S 
Time Hr Night +20 
S#Dk#>#WSUNSETH24#?100:08 
| Day/Night | Transparency | $#DISDAYTIME#=1?100:0$ 
Or 
S#DISDAYTIME#==true?100:0S 
Transparency | S#Ds#>=1&&#Ds#<12?0:100$ 
Or 
S#DH#>=0&&#DH#<12?100:08 
1-12 opacity is 0 else 100. 
Day of week Transparency | S#DOW#==1?100:0S 
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3k/5k/10k 


|_ oll 


Transparency 





3k 

S#ZSC#<3000?10000:08 

5k 
S#ZSC#>=3000&&#ZSC#<=5000?10000:08 
10k 

S#ZSC#>5000?10000:08 








Show During 
“RM” 


Transparency 


S#DH#<12?AM:PMS or SHDH#<12?100:0S for AM and 
S#DH#<12?0:100S for PM 





Heart Rate 


HR -45 

SHZHR#<45 ?200:0S 

HR +45/-100 
SHZHR#>=45&&HZHR#<=100?200:0S 
HR +100/-160 
S#ZHR#>=101&&HZHR#<=160?200:08 
HR +160 

S#ZHR#>160?200:05 





Next Day Text 


Standard Week Day (Sunday (1) to Saturday (7)) (WHITE) 
#DOWB# 

Week Day + 1 (RED) 
((4DOWB#+1)-(7*(floor(4DOWB#*(10/7)/10)))) 

Week Day + 2 (BLUE) 
((HDOWB#+2)-(7*(floor(4DOWB#*(10/6)/10)))) 





Forecast Next 
Day Text 


Standard Week Day (Sunday (1) to Saturday (7)) (WHITE) 
HWFACI# 

Week Day + 1 (RED) 
((AWFACI#+1)-(7*(floor(#WFACI#*(10/7)/10)))) 

Week Day + 2 (BLUE) 
((AWFACI#+2)-(7*(floor(#WFACI#*(10/6)/10)))) 








Back & Forth 
Motion 
[Pendulum] 


Y Position: 


(219+sin((#DWFSS#))*10) 

Or 

(162+sin((#DWFSS#))*70) 

Or 

(160+(120*(sin(4DWE#*2*pi)))) 

Or 
S(round(floor(2*#DWE#+.5)/2))=(floor((2*#DWE#+.5)/2))?160+12 
0*(-14+2*((2*#DWE#+.5)-(floor(2*#DWE#+.5 )))):160-120*(- 
1+2*((2*#DWE#+.5)-(floor(2*#DWE#+.5))))S 








Fade In/Out 


Transparency 


((sin(#DWE#*5))*50+50) 
ccc 





Transparency 


S#Ds#>14&&#Ds#<27?100:0S 
Visible for specified time 





10sec blink 


Transparency 


Sfloor(#DNOW#/10000)%2=0?100:0S 








Font 
(Growing) 


1sec 


((.2+(HDWE#)%1)*30) 
.2is a % of full font size of 30 
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Battery 


Battery 
Progress 


Fill Ratio 


(clamp(#PBN#, 0, 100)/100) 





Transparency 


SHPBN#>0?100:0S 








WiFi 


Phone WiFi 
Level 


Transparency 


SHPWL#=1?100:0S (1-5) 











HWSUNRISE24# 











Other 
Expressions 
for use and 
example 





https://www.fa 
cer.io/watchfa 
ce/nnnzoD8Ot 
5 


((sin(#ZHR#*100))*50+50) 





(50+50*sin(2*pi*#Dsm#*#ZHR#/60)) 


Tested and working fine! Thanks Mike, just replaced 2*pi for 6.28 
(50+50*sin(6.28*#Dsm#*#ZHR#H/60)) 


Note: in watches without sensor the tag returns zero and break 
the formula, so is better to use a conditional like 
SHZHR#>0?(50+50*sin(6.28*#Dsm# * HZHR#/60)):(100- 
200*((#Dsm#/2)%0.5))S 

where if the tag is zero remains a steady half of a second pulse. 
Take out the spaces between the tags!!!! 





Rotation 


((((((#WRH#+(#WRm#/60))/24) *(360))+225)+#DWEKS#)- 
(#DWFHS#+180)) 





Rotation 


((((((((HWRH#+12)/2)+(HWRm#/60))/24)*(360))+225)+#DWEKS#)- 
(#DWFHS#+180)) 





Rotation 


((((((#WRH#+(#WRm#/60))/24) *(360))+225)+#DWEKS#)- 
(#DWFHS#+180)) 





Rotation 


((((((#WSH#+(#WSm#/60))/24)*(360))+135)+#DWEFKS#)- 
(#DWFHS#+180)) 





Rotation 


((((((((HWSH#4+12)/2)+(#WSm#/60))/24)* (360))+135)+#DWFKS#)- 
(#DWFHS#+180)) 





Rotation 


((((((#WSH#+(#WSm#/60))/24)*(360))+135)+#DWFKS#)- 
(#DWFHS#+180)) 





Rotation 


((#DWFKS#)-(#DWFHS#+180)) 





Rotation 


((((((((((((#DH#/24)+#D D#)*3)/1096)+#Dyyyy#)/(850481/1052160 
0))- 
floor((((((((((#Dsm#/60)+#Dm#)/60)+#DH#)/24)+#DD#)*3)/1096)+ 
#Dyyyy#)/(850481/10521600)))*180)+11)+90)*(1))+85) 





Transparency 


S(#DH#+(#Dm#/60))>(HWRH#+(#WRm#/60))& &(#DH#+(#Dm#/60 
))<(#WSH#+(#WSm#/60))?0:100S 





weather and 
daytime visible 


Transparency 


SHDISDAYTIME#==true& &#WFACI#==01?100:05 





(round(#BLN#/10)*10)) 
Sets transparency from 100 to 0, step 10. 
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(Other Tuts) 


Small obj orbiting edge of watch / second hand 


X-position: 
(160 + cos((#DWFS# - 90) * ((pi)/180)) * 140) 
Y-position: 
(160 + sin((#DWEFS# - 90) * ((pi)/180)) * 140) 


The 140 is what controls the spacing from the center 
The DWFS tag is for seconds that "jump”. if you want it to move smoothly use DWFSS. 
If you want to do one for hours use DWFK (I think). etc. 


It is the way | use. when | make my own hand image | will crop the size of the image like the left one, so the hand will rotate at the 
center hole of the hand. 
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Basic Recipes 


If you want to get started in more advanced techniques, we've put together a small collection of recipes for commonly used 
techniques. 

Be sure to check out the Community for more techniques! 

Width-Based Battery Indicator Bar 

There are many ways to create a custom battery indicator, but one of the easiest is to use a shape & the width property to show the 
battery level for a watch or phone. 

You can inspect this watch face to see it in action and look under the hood! 


Recipe for Width-Based Battery Indication 
Property: Width 
((HBLN#)*1.55) 


Rotate Any Element Over Time 

While we provide essential elements for analog time, you might have an idea that makes a second/minute/hour hand out of a 
different element altogether (rotating text, shape, cat with laser eyes, etc). This recipe will show you how to rotate any element 
based on the time. For our example we use 'seconds': #DWFSS#, but you could also use a different tag. 

You can inspect this watch face to see it in action on a shape element! 


Recipe for Rotating With Seconds 
Property: Rotation 
#DWFSS# 


Back & Forth Motion 
You can use the sine & cosine functions to make back & forth movement, as demonstrated by this laser cat's tongue: 
You can inspect this watch face to see it in action and look under the hood! 


Recipe for Back & Forth Motion 
Property: Y Position 

(219 + sin((#DWFSS#))*10) 

Or 

(162+sin((#DWFSS#))*70) 


Advanced Animations 


In order to help advanced users with a series of samples of possibilities, we’ve created the ‘Expression Playground’ watch face. This 
watch face isn’t very useful for telling time, but you can use Inspection Mode to see how we achieve certain animations and effects 
with Facer. 

How does this watch face work? 

We’ll go through a couple of specific expressions used in the watch face in the recipes below. You can open the watch in inspector 
mode to see how it all works: 


& https://www.facer.io/watchface/1WkGIWDQzf/inspect 





Feel free to make changes, nothing will get saved so you’re free to play! 
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Fade In / Fade Out 


These recipes cover 3 behaviors: Fade in when the watch wakes up, Fade out when the watch wakes up, or Fade In/Out on a loop. 


Recipe for Fade In When the Watch Wakes: 
Property: Transparency 
((interpAccel(HDWE#, O, 2, 2)*100)) 


Recipe for Fade Out When the Watch Wakes: 
Property: Transparency 
(100-(interpAccel(#DWE#, O, 2, 2)*100)) 


Recipe for Looping Fade In & Fade Out: 

Property: Transparency 

((sin(#DWE#*5))*50+50) 

Pendulum Motion 

Allow an element to move as if swinging from a string: 


Recipe for Pendulum Motion: 

Property: Rotation (sin(#DWE#*2)*50) 

“Breathing” Motion 

Have an element cycle properties easing in & out, to create a ‘breathing’ effect 


Recipe for Breathing Opacity: 
Property: Transparency ((sin(#DWE#*2)*60)+50) 


Recipe for Breathing Size: 

Property: Radius ((sin(#DWE#*2)*40)+50) 
Basic Orbit 

Orbit an element in a circular motion 


Recipe for Basic Orbit: 
Property: X Position (160 + sin(#DWFSS#/4)*50) 
Property: Y Position (160 + cos(#DWFSS#/4)*50) 


Animated Battery Power Level Indicators 


Here are the three basic possibilities we will speak about in this tutorial. 
This tutorial should show you, in a simple way & at one place, how to elevate your watch faces with some basic expressions*. 


Super Simple Percentage Number 
This is maybe something you are already using at your watch faces. Tag 
#BLP# 


shows your watch battery level as a text. 
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Color Changing 
Changing of the colors according to the power percentage could be done with a duplication of element. | use usually 3 elements in 
three colors. Visibility of different colored elements could be changed at the transparency. Here an example for 


Green 


S#BLN#>40?100:0S 


Yellow 


SHBLN#>=20&&#BLN#<=40?100:0S 


Red 
S#BLN#<20?100:08 
In those expressions a tag #BLN# is using instead of #BLP# because we need a “pure” number to be able to compare it with another 


value. This color change could be apply for any battery level indicator in this tutorial (number, hand, or object) 


Linear Battery Indicator 


For this effect | use the standard “Rectangle” you could find in Facer.io Creator as Shape or | create an image especially for this 
purpose. In the case of an own picture, please be sure that your “indicator” covers the full area of picture, like this: 


Red line shows only the end of the image. The second important thing is to set correct align according to the “growing” object in the 
right way: 


So, the last thing we need is to make the “Height” of the object dynamic & appropriate to the battery level. If the “full battery level” 
means for example the number “48”, the final expression would be: 


Height: 
(#BLN#*0.48) 


And it’s done. 


For changing the colors please use the same process as at the “Super Simple Percentage Number” part. 


Hand Indicator 


For those purposes | recommend to use of your own hands saved as PNG image (or another one with transparent background). Very 
important is the position of the hand according to the image. In the standard settings the pictures and objects rotate around the 
image centre. So, if you wish to have a nice and smooth movements, please check that the image centre is also the centre of your 
hand, like this: 


Red line again shows only the end of the image. White background should be 100% transparent. 
After you find the correct position of your hand according to the dial, e.g.: 
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The last thing is to set a dynamic rotation. If you are not sure what angle is your starting and the end position, please just rotate your 
hand into the limit positions like: 


Now we have the range we are moving in. In this case 300 degree (of 360 degree for a full circle), starting (Tag #BLN# = 0) at -150 
degree. The battery level is divided into 100 parts. It means that 1% change of battery level are 3 degrees change at the rotation. So 


the final expression will be: 


Rotation: 


(-150+(#BLN#*3)) 


Done! 
| hope, it could helps you and | would be happy, if you leave me a comment how well does it work at your watch face. 


Here is an “inspection mode open” watch face, where you could see how does it work for linear battery and hand dials temperature: 


*There are also another great tutorials and/ or explanations in the facer.io community done by e.g. @Bertso and @jimmycheung like battery indicator or hand 
rotation. If you know about further tutorials, | will be happy to link it too. 
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PANGS 








Tags are dynamic values you can add to the dynamic attributes of a watch face layer. Facer tags are always surrounded by 
hashtags: #Ds#. Dynamic means the value can be different under different circumstances. For example, the #Ds# is the current 
second value, so every second this value changes. 








TAGS DEFINITION EXAMPLE OUTPUT 
Date & Time 
#DWE# Time elapsed since last 5.12 
watch face view (in seconds 
with 0.01 parts) 
#DNOW# Current timestamp 1550780363 
#DSYNC# Timestamp at which watch 1550780132 
face was synced 
#Dy# Year 2016 
#Dyy# Short Year 16 
#Dyyyy# Long Year 2016 
#DM# Month in Year (Numeric) 11 
#DMM# Month in Year (Numeric) 11 
with leading 0 
#DMMM# Month in Year (Short String) | Nov 
#DMMMM# Month in Year (String) November 
#DW# Week in Month 2 
#Dw# Week in Year 45 
#DD# Day in Year 313 
#Dd# Day in Month 8 
#DdL# Day in Month with leading 0 | 08 
#DIM# Maximum days in the 30 
current month 
#DE# Day of Week (Short String) Tue 
#DES# First letter of the day of T 
Week 
#DOW# Day of week int (0-6 where O | 2 
is Sunday) 
#DOWB# Day of week int (1-7 where 1 | 3 
is Sunday) 
#DEEEE# Day of Week Tuesday 
#DF# Day of Week in Month 2 
#Dat#t AM/PM PM 
#Db# Hour in day using user's 
preferred format (12 hour or 
24 hour clock). NOTICE: This 
is the recommended tag for 
any digital times. 
12 
#Dh# Hour in Day (1-12). NOTICE: | 12 
This should only be used in 
specific cases where #Db# 
does not work. 
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#Dk# Hour in Day (1-24). NOTICE: | 12 
This should only be used in 
specific cases where #Db# 
does not work. 

#DH# Hour in Day (0-23) 12 

#DK# Hour in Day (0-11) 0 

#DHZ# Hour in Day (leading zero) 08 
(00-23) 

#DkZA# First Digit of the Hour in Day | 1 
(0-2) 

#DkZBH Second Digit of the Hour in 2 
Day (0-9) 

#DKZ# Hour in Day (12 hour, 00 
leading zero) (00-11) 

#DhZ# Hour in Day (12 hour, 09 
leading zero) (01-12) 

#DhZA# First Digit (12 hour) of the in | 1 
Day (0-1) 

#DhZBH Second Digit (12 hour) of the | 2 
in Day (0-9) 

#DhoT# Value for Hour Rotation (12 | 360 
hour) (30-360 with intervals 
of 30) 

#DhoTb# Value for Hour Rotation (24 | 180 
hour) (0-345 with intervals 
of 15) 

#DWFK# Value for Hour Rotation (12. | 360 
hour) (30-360 with intervals 
of 30) 

#DWFH# Value for Hour Rotation (24 | 180 
hour) (0-345 with intervals 
of 15) 

#DWFKS# Smooth Value for Hour 389 
Rotation (12 hour) (30-390) 

#DWFHS# Smooth Value for Hour 194.5 
Rotation (24 hour) (0-359.75 
with 0.25 parts) 

#DhT# String value for hour (12 twelve 
hour) 

#DkT# String value for hour (24 twelve 
hour) 

#Dm# Minute in Hour 58 

#DmZ# Minute in Hour (leading 08 
zero) 

#DWFM# Value for minute hand 348 
rotation (0-354 with 
intervals of 6) 

#DWFMS# Smooth Value for minute 351.8 
hand rotation (0-359.9 with 
0.1 parts) 

#DmT# String value for minutes fifty eight 
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#DmMMT# String value for minutes fifty 
(tens place) 

#DmST# String value for minutes eight 
(ones place) 

#Ds# Second in minute 38 

#DsZ# Second in minute (leading 09 
zero) 

#Dsm# Second in minute plus 38.805 
milliseconds 

#DseT# Value for second hand 228 
rotation (0-354 with 
intervals of 6) 

#DWFS# Rotation value for second 228 
hand (0-354 with intervals of 
6) 

#DWFSS# Smooth Rotation value for 232.829999946838 
second hand (0- 
359.99399991780274) 

#DSMOOTH# Smooth Rotation (boolean) true 

#Dz# Timezone Abbreviation PST 

#Dzzzz# Timezone Name (Long - if PST 
available) 

#DWR# Day of Week Rotational 154.28571428571428 
Code 
(51.42857142857142(for 
sunday)-360(for saturday) 
with intervals of 
51.42857142857142) 

#DMR# Day of Month Rotational 92.90322580645162 
Code 
(11.612903225806452(for 
1st)-360(for 31th) with 
intervals of 
11.612903225806452) 

#DYR# Day of Year Rotational Code | 313 
(1-365(non-leap year),or 1- 
366(leap year)) 

#DMYR# Month in Year Rotational 330 
Code (30-360 with intervals 
of 30) 

#DUh# Hour in Day (UTC) (1-12) 8 

#DUk# Hour in Day (UTC) (1-24) 20 

#DUH# Hour in Day (UTC) (0-23) 20 

#DUK# Hour in Day (UTC) (0-11) 8 

#DUb# Hours in day using user’s 
preferred format (UTC) 

(12/24) 
undefined 
#DUHZ# Hour in Day (leading zero) 05 





(UTC) (00-23) 
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#DUkZ# Hour in Day (leading zero) 02 
(UTC) (01-24) 

#DUKZ# Hour in Day (12 hour, 08 
leading zero) (UTC) (00-11) 

#DUhZ# Hour in Day (12 hour, 08 
leading zero) (UTC) (01-12) 

#DUm# Minute in Hour (UTC) 58 

#DUmZ# Minute in Hour (leading 09 
zero) (UTC) 

#DUs# Second in minute (UTC) 38 

#DUsZ# Second in minute (leading 08 
zero) (UTC) 

Device information 

#BLP# Watch Battery Level 46% 
Percentage 

#BLN# Watch Battery Level Integer | 46 

#BTCH Watch Battery Temperature | 31°C 
(°C) 

#BTI# Watch Battery Temperature | 87°F 
(°F) 

#BTCN# Watch Battery Temperature | 31 
(Celcius) 

#BTIN# Watch Battery Temperature | 87 
(Fahrenheit) 

#BS# Watch Battery Charging 0 
Status 

H#ZLP# Low Power Mode null 

#ZDEVICE# Device Name Smartwatch 

#ZMANU# Device Manufacturer Facer 

#ZISROUND# Device Screen Shape (true, if | false 
circular) 

#PBP# Phone Level Percentage 79% 

#PBN# Phone Level Integer 79 

#PWL# Phone WiFi Level 3 

#ZWC# Number of watch face 26 
activations since synced 

Weather information 

#WM# Weather Units (F/M) F 

#HWLC# Weather Location Los Angeles 

HWTH# Today's High 86 

HWTL# Todays' Low 63 

HWCT#H Current Temp 84 

#WCCI# Current Condition Icon 03 

#WCCT# Current Condition Text Fair 

#WCHN# Current Humidity Number 40 

HWCHP# Current Humidity 40% 
Percentage 

#DISDAYTIME# Returns true if time is after true 
sunrise and before sunset 

#WRh# Sunrise hour (1-12) 5 
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#WRhZ# Sunrise hour (leading zero) 05 
(01-12) 

#WRH# Sunrise hour (0-23) 5 

#WRHZ# Sunrise hour (leading zero) 05 
(00-23) 

#WRm# Sunrise minute (0-59) 50 

#WRmZ# Sunrise minute (leading 06 
zero) (00-59) 

#WSh# Sunset hour (1-12) 8 

#WShZ# Sunset hour (leading zero) 08 
(01-12) 

#WSH# Sunset hour (0-23) 20 

#WSHZ# Sunset hour (leading zero) 01 
(00-23) 

#WSm# Sunset minute (0-59) 6 

#WSmZ# Sunset minute (leading zero) | 06 
(00-59) 

#WSUNRISE# Time of sunrise 5:50 am 

HWSUNSET# Time of sunset 8:06 pm 

H#WSUNRISE24# Time of sunrise (24) 5:50 

#WSUNSET24# Time of sunset (24) 20:06 

#WSUNRISEH# Hour of sunrise 5 

#WSUNRISEM# Minute of sunrise 50 

#WSUNSETH# Hour of sunset 8 

#WSUNSETM# Minute of sunset 06 

#WSUNRISEH24# Hour of sunrise (24) 5 

#WSUNSETH24# Hour of sunset (24) 20 

HWFAH# Forecast Day 1 High 86 

HWFAL# Forecast Day 1 Low 63 

HWFACT#H Forecast Day 1 Condition Clear 
Text 

#WFACI# Forecast Day 1 Condition 01 
Icon 

#WFBH#H Forecast Day 2 High 85 

#HWFBL# Forecast Day 2 Low 63 

#HWFBCT# Forecast Day 2 Condition Sunny 
Text 

#WFBCI# Forecast Day 2 Condition 01 
Icon 

HWFCH# Forecast Day 3 High 85 

#WFCL# Forecast Day 3 Low 63 

HWFCCT# Forecast Day 3 Condition Sunny 
Text 

#WECCI# Forecast Day 3 Condition 01 
Icon 

#WFDH# Forecast Day 4 High 88 

#WFDL# Forecast Day 4 Low 64 

#HWFDCT# Forecast Day 4 Condition Sunny 





Text 
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#WFDCI# Forecast Day 4 Condition 01 
Icon 
HWFEH# Forecast Day 5 High 86 
#HWFEL# Forecast Day 5 Low 68 
HWFECT#H Forecast Day 5 Condition Mostly Sunny 
Text 
#WFECI# Forecast Day 5 Condition 01 
Icon 
Health/Fitness information 
#ZSC# Step Count 1556 
HZHR# Average Heart Rate (bpm) 76 
Interactions 
#SWISRUNNING# Stopwatch Active State (6) 
(boolean) 
HSWEMS# Stopwatch elapsed 6034 
milliseconds 
HSWES# Stopwatch elapsed seconds 6 
#SWEM# Stopwatch elapsed minutes | 4 
HSWEH# Stopwatch elapsed hours 0.3 
Programmables 
Programmable tags can be updated using the programmable widgets of the Facer Creator. There are currently 6 variables, VAR_1 
to VAR_6 
#VAR_1# Value for interactive 12 
variable 1 
#VAR_1 _T# Timestamp at which 1550780123 
interactive variable 1 was 
last updated 




















EXPRESSIONS 


Math expressions can take your watch face to next level. Facer supports arithmetical operations as well as a handful of math 
functions. You can also drop facer tags into expressions to make them even more dynamic! 
NOTE: Math expression require parentheses. So, this will work (1+1) and this will not 1+1 ! 


























OPERATOR DEFINITION EX EXPRESSION EX OUTPUT 
Operators 
+ Addition operator | (3+2) 5 
- Subtraction (3-2) 1 
operator 
ba Multiplication (3*2) 6 
operator 
/ Division operator | (3/2) 1.5 
% Modulo operator | (5%2) 1 
Constants 
pi Value of pi (pi) 3.141592653589793 
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Math expressions can take your watch face to next level. Facer supports arithmetical operations as well as a handful of math 
functions. You can also drop facer tags into expressions to make them even more dynamic! 
NOTE: Math expression require parentheses. So, this will work (1+1) and this will not 1+1 ! 


OPERATOR 





DEFINITION 


EX EXPRESSION 


EX OUTPUT 


























e Value of e (e) 2.718281828459045 
Functions 

rand(min, max) Random number | (rand(1, 10)) 1 

generator 
wakeRand(min, max) Random number | (wakeRand(1, 10)) 1 

generator that's 

updated every 

time the watch 

face goes into 

active mode 
abs(number) Absolute value (abs(-10)) 10 

function 
sin(number) Sine function (sin(1)) 0.8414709848078965 
cos(number) Cosine function (cos(1)) 0.5403023058681398 
tan(number) Tangent function | (tan(1)) 1.5574077246549023 
round(number) Round function (round(1.6)) 2 


(get the closest 
integer) 


















































ceil(number) Ceiling function (ceil(1.2)) 2 
(gets the next 
highest integer) 

floor(number) Floor function - (floor(1.6)) 1 
gets the next 
lowest integer) 

log(number) Log function (log(2)) 0.6931471805599453 

log2(number) Log base 2 (log2(2)) 1 
function 

log10(number) Log base 10 (log10(2)) 0.3010299956639812 
function 

sqrt(number) Square root (sqrt(4)) 2 
function 

cbrt(number) Cube root (cbrt(8)) 2 
function 

exp(number) Gets E to the x (exp(2)) 7.38905609893065 
power 

expm1(number) Gets E to the x (expm1(2)) 6.38905609893065 
power minus 1 

deg(radians) Convert radians (deg(1)) 57.29577951308232 
to degrees 

rad(degrees) Converts degrees | (rad(180)) 3.141592653589793 
to radians 
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Math expressions can take your watch face to next level. Facer supports arithmetical operations as well as a handful of math 
functions. You can also drop facer tags into expressions to make them even more dynamic! 
NOTE: Math expression require parentheses. So, this will work (1+1) and this will not 1+1 ! 


OPERATOR 


DEFINITION 


EX EXPRESSION 


EX OUTPUT 

















clamp(current, min, max) | Restrict 'current' (clamp(#Ds#, 15, 45)) 31 
value to the 'min' 
& 'max' 
squareWave(current, Creates asquare | (squareWave(#Ds#, 15, | 15 
amplitude, period, wave pattern out | 10, 0)) 
xOffset) of 'current' value 
interpAccel(current, min, | Creates aease-in | (interpAccel(#Ds#, 0, 0.2669444444444445 
max, accelerationFactor) | transition with 60, 2)) 
‘current' value 
interpDecel(current, min, | Creates a ease- (interpDecel(#Ds#, 0, 0.9454258487654321 
max, accelerationFactor) | out transition 60, 2)) 
with 'current' 
value 
interpAccelDecel(current, | Creates a ease-in- | (interpAccelDecel(#Ds#, | 0.5261679781214715 


min, max) 


out transition 
with 'current' 
value 


0, 60)) 





gyrox() 


Outputs the X 
axis of the gyro 
sensor, 
accumulated into 
positional 
coordinates 


3.9241372946780517 


3.9241372946780517 





gyroY() 


Outputs the Y 
axis of the gyro 
sensor, 
accumulated into 
positional 
coordinates 


-1.0019503694835041 


1.0019503694835041 





accelerometerX() 


Outputs the X 
axis of the 
accelerometer 
sensor, 
accumulated into 
positional 
coordinates 


-5.273500685642811 


-5.273500685642811 











accelerometeryY() 
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Outputs the Y 
axis of the 
accelerometer 
sensor, 
accumulated into 
positional 
coordinates 





7.629725700177308 





7.629725700177308 
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EXPRESSIONS 


Math expressions can take your watch face to next level. Facer supports arithmetical operations as well as a handful of math 
functions. You can also drop facer tags into expressions to make them even more dynamic! 

NOTE: Math expression require parentheses. So, this will work (1+1) and this will not 1+1 ! 

OPERATOR DEFINITION EX EXPRESSION EX OUTPUT 
gyroRawX() Outputs the raw 6.64500963775291 6.64500963775291 
X axis of the gyro 
sensor, which 
detects rotational 
acceleration 
gyroRawY() Outputs the raw -3.9204606214134596 | - 
Y axis of the gyro 3.9204606214134596 
sensor, which 
detects rotational 
acceleration 
accelerometerRawX() Outputs the raw 1.4595613230651239 1.4595613230651239 
X axis of the 
accelerometer 
sensor 
accelerometerRawY() Outputs the raw 9.87964297713896 9.87964297713896 
Y axis of the 
accelerometer 
sensor 


SO] NPE RON TANES 


Conditionals are the most complicated and dynamic way to create a watch face. 
They take this form: 









































S$ EQUALITY TEST ? EXPRESSION IF TEST IS TRUE : EXPRESSION IF TEST IS FALSE $ 


The first space is for our equality test, which is going to equal true or false. There are five types of operators available: 




















OPERATOR DEFINITION | EX EXPRESSION EX OUTPUT 
=or=- Is equal to (1=1) or (1==1) true 
l= Is not equal to (1!=0) true 
Is greater than (2>1) true 
< Is less than (O<1) true 
>= Is greater than or equal | (2>=1) true 
to 
<= Is less than or equal to (O<=1) true 
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Now let's make our own. We'll fill it in step-by-step. Let's start with a blank slate. We'll develop a conditional to use for the 
Transparency attribute. All of the those dollar signs and question marks look confusing at first, but you'll get used to them (if you 
have a programming background, you probably already recognize the ternary operator!): 





Now let's fill in that spot with a simple example. We're going to make an expression that will make a layer appear only before 
noon. This expression would be added to the opacity attribute of the layer. We'll use the #Da# and check if it's "AM": 


S#Da#==AM?_:_$ 


Next, we'll fill in the EXPRESSION IF TRUE part of the conditional. When #Da# == "AM" is true, we want our layer to appear, so 
we'll want the opacity to be 100: 


S#Da#==AM?100:_$ 


Lastly, we'll fill in the EXPRESSION IF FALSE part of the conditional. When #Da# == "AM" is false, we want our layer to disppear, so 
we'll want the opacity to be 0: 


S#Da#==AM?100:0S 
That's it! You just created your first conditional. 
Now some advice: 


Don't use " marks before and after texts used in conditions. 








Don't use spaces ("") before and after part of conditions (wrong: S #Da# == AM ? 100: 0S right: S#Da#==AM?100:0S) 





Boolean logic 


For the ultra adventurous, the EQUALITY TEST portion of a Facer conditional also supports a maximum of 3 basic 
Boolean operators in any given formula. (Basic boolean operators are | | and &&). Have fun! 


A note about boolean operators in conditionals, it's important to avoid putting parentheses around equality and boolean 
expressions. Here are some examples: 


These will be ok: 
Sa 10 |e —— ee OS 


S (ivi) == (@) | (2) == (i) 2 te oO &§ 
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These will have unexpected results: 
Sa ee OS 


Sie (le — ee || ee OS 
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WatchMaker Watch Face Designer 


WatchMaker Tags 


Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 
be printed. 
All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 
selected tag will be inserted at the cursor position 


































































































Tag Description Example 
Date 
{dd} Day in month 9 
{ddz} Day in month (with leading 09 
0) 
{ddy} Day in year 282 
{ddw2} Day of week Th 
{ddw} Day of week Thu 
{ddww} Day of week Thursday 
{ddw0} Day of week (Sun = 0, Sat = 5 
6) 
{ddim} Days in current month 31 
{dn} Month in year 1 
{dnn} Month in year (with leading | 01 
0) 
{dnnn} Month in year Jan 
{dnnnn} Month in year January 
{dy} Year (2 digits) 14 
{dyy} Year (4 digits) 2014 
{dwm} Week in month 4 
{dw} Week in year 40 
Time 
{dh} Hour in day (1-12) 9 
{dh11} Hour in day (0-11) 21 
{dh24} Hour in day (1-24) 9 
{dh23} Hour in day (0-23) 21 
{dhutc12} Hour in day UTC (12 hr) 8 
{dhutc12z} Hour in day UTC (12 hr with | 08 
leading zero) 
{dhutc24} Hour in day UTC (24 hr) 20 
{dhutc24z} Hour in day UTC (24 hr with | 20 
leading zero) 
{dutcoff} UTC Offset +0100 
{dht} Hour in day text (1-12) nine 
{dh24t} Hour in day text (1-24) twenty one 
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WatchMaker Tags 








Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 
be printed. 

All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 
selected tag will be inserted at the cursor position 






















































































Tag Description Example 

{dhz} Hour in day (1-12) (with 09 
leading zero) 

{dh11z} Hour in day (0-11) (with 21 
leading zero) 

{dh24z} Hour in day (1-24) (with 09 
leading zero) 

{dh23z} Hour in day (0-23) (with 21 
leading zero) 

{dm} Minute in hour 7 

{dmz} Minute in hour (with leading | 07 
zero) 

{dhtt} Hour in day (1-12 tens) 0 

{dhto} Hour in day (1-12 ones) 9 

{dh11tt} Hour in day (0-11 tens) 0 

{dh11to} Hour in day (0-11 ones) 9 

{dh24tt} Hour in day (1-24 tens) 0 

{dh24to} Hour in day (1-24 ones) 9 

{dh23tt} Hour in day (0-23 tens) 0 

{dh23to} Hour in day (0-23 ones) 9 

{dmz} Minute in hour (with leading | 07 
zero) 

{dmt} Minute in hour (tens) 3 

{dmo} Minute in hour (ones) 1 

{dmat} Minute in hour text (all) thirty one 

{dmtt} Minute in hour text (tens) thirty 

{dmot} Minute in hour text (ones) one 

{ds} Second in minute 2 

{dsz} Second in minute (with 02 
leading zero) 

{da} AM/PM AM 

{dss} Milliseconds 32 

{dssz} Milliseconds (with leading 032 
zeros) 

{dsps} Seconds * 1000 + 1207 
milliseconds 

{depoch} Seconds since epoch 1495105593 

{dz} Timezone BST 
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WatchMaker Tags 


Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 


be printed. 


All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 


selected tag will be inserted at the cursor position 


Tag 


Description 


Example 




























































































{dtp} Time (% 24 hours) 0.74 
{drh} Rotation value for hour (12h, | 290 
adj for mins) 
{drh24} Rotation value for hour hand | 145 
(24h, adj for mins) 
{drhO} Rotation value for hour hand | 270 
(12h) 
{drm} Rotation value for min hand | 242 
(adj for secs) 
{drs} Rotation value for second 156 
hand 
{drss} Rotation smooth value for 156.2 
second hand 
{drms} Rotation value for 193.4 
milliseconds 
Color Switcher 
{ucolor} Current Color ffO000 
Counter 
{c_elapsed} Seconds elapsed since 50 
loaded 
{c_0 100 2 st} 0 to 100 in 2s, then stop 50 
{c_0 100 2 rp} 0 to 100 in 2s, then repeat 50 
{c_0 100 2 rv} 0 to 100 in 2s, then reverse 50 
{c_0 100 2 rv_2}| As above with 2s start delay | 50 
Time Zone 
{tz1l} Extra Time Zone 1 Location Los Angeles 
{tz1o} Extra Time Zone 1 Offset - 8:00 
{tz1t} Extra Time Zone 1 Time 01:26 
{tzirh} Extra Time Zone 1 Rotation 42 
hour hand 
{tzirh24} Extra Time Zone 1 Rotation 24 
hour hand (24h) 
{tzirm} Extra Time Zone 1 Rotation 160 
minute hand 
{tz2I} Extra Time Zone 2 Location London 
{tz2o} Extra Time Zone 2 Offset + 0:00 
{tz2t} Extra Time Zone 2 Time 09:26 
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WatchMaker Tags 


Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 


be printed. 


All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 


selected tag will be inserted at the cursor position 


Tag 


Description 


Example 













































































{tz2rh} Extra Time Zone 2 Rotation 283 
hour hand 

{tz2rh24} Extra Time Zone 2 Rotation 141 
hour hand (24h) 

{tz2rm} Extra Time Zone 2 Rotation 160 
minute hand 

{tz3l} Extra Time Zone 3 Location Tokyo 

{tz3o0} Extra Time Zone 3 Offset + 9:00 

{tz3t} Extra Time Zone 3 Time 18:26 

{tz3rh} Extra Time Zone 3 Rotation 190 
hour hand 

{tz3rh24} Extra Time Zone 3 Rotation 95 
hour hand (24h) 

{tz3rm} Extra Time Zone 3 Rotation 160 
minute hand 

...up to 3 time zone locations can be specified in settings 

Battery 

{bl} Battery level 71 

{blp} Battery level % 71% 

{br} Rotation value for Battery 250 
level 

{btc} Battery temperature (C) 27 

{btf} Battery temperature (F) 81 

{btcd} Battery temperature (C) 27°C 
(percent) 

{btfd} Battery temperature (F) 81°F 
(percent) 

{bc} Battery charging status Charging 

Phone 

{pbl} Battery Phone level 71 

{pblp} Battery Phone level % 71% 

{pbr} Rotation value for Battery 250 
Phone level 

{pbtc} Battery Phone temperature 27 
(C) 

{pbtf} Battery Phone temperature | 81 











(F) 
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WatchMaker Tags 


Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 


be printed. 


All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 


selected tag will be inserted at the cursor position 


Tag 


Description 


Example 


































































































{pbtcd} Battery Phone temperature 27°C 
(C) (percent) 
{pbtfd} Battery Phone temperature | 81°F 
(F) (percent) 
{pbc} Battery Phone charging Charging 
status 
{pws} Phone Wifi Strength % 0.7 
{pwc} Phone Wifi Connected Y/N Y 
Device 
{aname} Device name GT1505 
{aman} Device manufacturer samsung 
{awname} Watch name Motorola 360 
{around} Is round? true 
{atyre} Has flat tyre? true 
{abright} Is bright? true 
{adimlo} Dim mode supports lo-bit false 
only? 
{abss} Milliseconds since bright (-1 | 150 
for dim) 
{alat} Current latitude 40.7127 
{alon} Current longitude 74.0059 
{alatd} Current latitude (degrees) 40.7127° 
{alond} Current longitude (degrees) | 74.0059° 
{alatdd} Current latitude (degrees + 40.7127°N 
direction) 
{alondd} Current longitude (degrees + | 74.0059°E 
direction) 
{aalt} Current altitude 104.800 
Stopwatch 
{swh} Stopwatch hours 0 
{swm} Stopwatch minutes 1 
{sws} Stopwatch seconds 25 
{swss} Stopwatch milliseconds (2 274 
digits) 
{swsss} Stopwatch milliseconds (3 27 
digits) 
{swsst} Stopwatch milliseconds total | 1274 
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WatchMaker Tags 








Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 
be printed. 

All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 
selected tag will be inserted at the cursor position 

















































































































Tag Description Example 
{swr} Stopwatch is running? true 
{swrm} Stopwatch minute rotation 30 
{swrs} Stopwatch second rotation 45 
{swrss} Stopwatch millisecond 47.2 
rotation 
Weather 
{wl} Weather Location London 
{wt} Current Temperature 13 
{wth} Today's High 14 
{wtl} Today's Low 12 
{wtd} Current Temperature 13°C 
(degrees) 
{wthd} Today's High (degrees) 14°C 
{wtld} Today's Low (degrees) 12°C 
{wm} Weather Units Cc 
{wct} Current Condition Text Rain 
{wci} Current Condition Icon 10d 
{wh} Current Humidity Number 87 
{whp} Current Humidity Percentage | 87% 
{wp} Atmospheric Pressure 1003 
{wws} Wind Speed (mph) 6.2 
{wwd} Wind Direction (degrees) 140 
{wwdb} Wind Direction (NE) NE 
{wwdbb} Wind Direction (NNE) NNE 
{wcl} Cloudiness (%) 0.4 
{wr} Rain volume for last 3 hrs 30 
(mm) 
{wsr} Sunrise time 08:14 
{wss} Sunset time 17:15 
{wsrp} Sunrise time (% 24 hours) 0.3 
{wssp} Sunset time (% 24 hours) 0.7 
{wmp} Moon Phase (1=young, 3 
5=full, 9=old) 
{wml} Weather manual location New York 
{wlu} Weather last update 15:08:27 
{wfOdt} Forecast Day 0 Temp 11 
{wfOdth} Forecast Day 0 High 12 
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WatchMaker Tags 


Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 


be printed. 


All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 


selected tag will be inserted at the cursor position 


Tag 


Description 


Example 


































































































{wfOdtl} Forecast Day 0 Low 5 

{wfOdct} Forecast Day 0 Condition Rain 
Text 

{wfOdci} Forecast Day 0 Condition 10d 
Icon 

{wf1dt} Forecast Day 1 Temp 11 

{wfidth} Forecast Day 1 High 12 

{wfidtl} Forecast Day 1 Low 5 

{wfidct} Forecast Day 1 Condition Rain 
Text 

{wf1dci} Forecast Day 1 Condition 10d 
Icon 

Weather forecasts are available up to day 5. Fahrenheit can be set in settings. 

Calendar 

{cex} Events Exist? true 

{c1t} Event 1 Text Gym 

{clex} Event 1 Exists? true 

{c1b} Event 1 Begin 19:00 

{c1br} Event 1 Begin Rotation (12 210 
hours) 

{c1bp} Event 1 Begin % 24 Hours 0.79 

{cle} Event 1 End 20:00 

{cler} Event 1 End Rotation (12 240 
hours) 

{clep} Event 1 End % 24 Hours 0.83 

{c1l} Event 1 Location Statue of Liberty 

{c1c} Event 1 Color ff0000 

{cli} Event 1 ID 520 

...calendars available for up to 10 unfinished events up to a week ahead (configurable in 

settings) 

Sensor 

{ssc} Step Count 1046 

{shr} Heart Rate 72 

{sprs} Barometric Pressure 0 

{sax} Accelerometer X 0.5 

{say} Accelerometer Y 0.5 
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WatchMaker Tags 


Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 
be printed. 
All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 
selected tag will be inserted at the cursor position 



































Tag Description Example 

{saz} Accelerometer Z 0.5 

{sex} Gyroscope X 0.5 

{sgy} Gyroscope Y 0.5 

{sgz} Gyroscope Z 0.5 

{scr} Compass for Rotation (needs | -210 
negative) 

{sct} Compass Display (O=N, 90=E, | 210 
180=S, 270=W) 

{sctd} Compass Display (degrees) 210° 

{scb} Compass Bearing (NE) SW 

{scbb} Compass Bearing (NNE) SSW 

{sctdb} Compass Display (degrees + | 210° SW 
NE bearing) 

{sctdbb} Compass Display (degrees + | 210° SSW 


NNE bearing) 





Complication (AWS 2.0+) 


















































{mitext} Complication 1 Text e.g. News Text 

{mititle} Complication 1 Title e.g. News Title 

{mivalue} Complication 1 Value e.g. 60, e.g. battery 
level 

{mimin} Complication 1 Min e.g. O, e.g. battery 
level 

{mimax} Complication 1 Max e.g. 100, e.g. battery 
level 

{m2text} Complication 2 Text e.g. News Text 

{m2title} Complication 2 Title e.g. News Title 

{m2value} Complication 2 Value e.g. 60, e.g. battery 
level 

{m2min} Complication 2 Min e.g. 0, e.g. battery 
level 

{m2max} Complication 2 Max e.g. 100, e.g. battery 
level 

{m3text} Complication 3 Text e.g. News Text 

{m3title} Complication 3 Title e.g. News Title 

{m3value} Complication 3 Value e.g. 60, e.g. battery 











level 
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Tags are placeholders that can be used in expressions to make your watch face dynamic. They can be used in Lua scripts or simply 


be printed. 
All properties that accept tags will open a tag picker dialog when clicking the little triangle next to the property value. The 


selected tag will be inserted at the cursor position 


























Tag Description Example 
{m3min} Complication 3 Min e.g. 0, e.g. battery 
level 
{m3max} Complication 3 Max e.g. 100, e.g. battery 
level 
Tasker 
{t...} Tasker Plugin Variable Example Value 
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